Log Search Analytics

curl --request POST \
  --url https://api.sophra.org/api/cortex/analytics/search \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "machine learning optimization",
  "searchType": "hybrid",
  "totalHits": 150,
  "took": 234,
  "sessionId": "sess_abc123",
  "facets": {
    "authors": [
      "John Smith",
      "Jane Doe"
    ],
    "tags": [
      "AI",
      "ML"
    ],
    "yearPublished": {
      "min": 2020,
      "max": 2024
    },
    "source": [
      "arXiv",
      "IEEE"
    ],
    "selectedFilters": {
      "contentType": "research-paper",
      "language": "en",
      "hasCode": true
    }
  }
}
'

import requests

url = "https://api.sophra.org/api/cortex/analytics/search"

payload = {
    "query": "machine learning optimization",
    "searchType": "hybrid",
    "totalHits": 150,
    "took": 234,
    "sessionId": "sess_abc123",
    "facets": {
        "authors": ["John Smith", "Jane Doe"],
        "tags": ["AI", "ML"],
        "yearPublished": {
            "min": 2020,
            "max": 2024
        },
        "source": ["arXiv", "IEEE"],
        "selectedFilters": {
            "contentType": "research-paper",
            "language": "en",
            "hasCode": True
        }
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: 'machine learning optimization',
    searchType: 'hybrid',
    totalHits: 150,
    took: 234,
    sessionId: 'sess_abc123',
    facets: {
      authors: ['John Smith', 'Jane Doe'],
      tags: ['AI', 'ML'],
      yearPublished: {min: 2020, max: 2024},
      source: ['arXiv', 'IEEE'],
      selectedFilters: {contentType: 'research-paper', language: 'en', hasCode: true}
    }
  })
};

fetch('https://api.sophra.org/api/cortex/analytics/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sophra.org/api/cortex/analytics/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'machine learning optimization',
    'searchType' => 'hybrid',
    'totalHits' => 150,
    'took' => 234,
    'sessionId' => 'sess_abc123',
    'facets' => [
        'authors' => [
                'John Smith',
                'Jane Doe'
        ],
        'tags' => [
                'AI',
                'ML'
        ],
        'yearPublished' => [
                'min' => 2020,
                'max' => 2024
        ],
        'source' => [
                'arXiv',
                'IEEE'
        ],
        'selectedFilters' => [
                'contentType' => 'research-paper',
                'language' => 'en',
                'hasCode' => true
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sophra.org/api/cortex/analytics/search"

	payload := strings.NewReader("{\n  \"query\": \"machine learning optimization\",\n  \"searchType\": \"hybrid\",\n  \"totalHits\": 150,\n  \"took\": 234,\n  \"sessionId\": \"sess_abc123\",\n  \"facets\": {\n    \"authors\": [\n      \"John Smith\",\n      \"Jane Doe\"\n    ],\n    \"tags\": [\n      \"AI\",\n      \"ML\"\n    ],\n    \"yearPublished\": {\n      \"min\": 2020,\n      \"max\": 2024\n    },\n    \"source\": [\n      \"arXiv\",\n      \"IEEE\"\n    ],\n    \"selectedFilters\": {\n      \"contentType\": \"research-paper\",\n      \"language\": \"en\",\n      \"hasCode\": true\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sophra.org/api/cortex/analytics/search")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"machine learning optimization\",\n  \"searchType\": \"hybrid\",\n  \"totalHits\": 150,\n  \"took\": 234,\n  \"sessionId\": \"sess_abc123\",\n  \"facets\": {\n    \"authors\": [\n      \"John Smith\",\n      \"Jane Doe\"\n    ],\n    \"tags\": [\n      \"AI\",\n      \"ML\"\n    ],\n    \"yearPublished\": {\n      \"min\": 2020,\n      \"max\": 2024\n    },\n    \"source\": [\n      \"arXiv\",\n      \"IEEE\"\n    ],\n    \"selectedFilters\": {\n      \"contentType\": \"research-paper\",\n      \"language\": \"en\",\n      \"hasCode\": true\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sophra.org/api/cortex/analytics/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"machine learning optimization\",\n  \"searchType\": \"hybrid\",\n  \"totalHits\": 150,\n  \"took\": 234,\n  \"sessionId\": \"sess_abc123\",\n  \"facets\": {\n    \"authors\": [\n      \"John Smith\",\n      \"Jane Doe\"\n    ],\n    \"tags\": [\n      \"AI\",\n      \"ML\"\n    ],\n    \"yearPublished\": {\n      \"min\": 2020,\n      \"max\": 2024\n    },\n    \"source\": [\n      \"arXiv\",\n      \"IEEE\"\n    ],\n    \"selectedFilters\": {\n      \"contentType\": \"research-paper\",\n      \"language\": \"en\",\n      \"hasCode\": true\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

POST

cortex

analytics

Log Search Analytics

curl --request POST \
  --url https://api.sophra.org/api/cortex/analytics/search \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "machine learning optimization",
  "searchType": "hybrid",
  "totalHits": 150,
  "took": 234,
  "sessionId": "sess_abc123",
  "facets": {
    "authors": [
      "John Smith",
      "Jane Doe"
    ],
    "tags": [
      "AI",
      "ML"
    ],
    "yearPublished": {
      "min": 2020,
      "max": 2024
    },
    "source": [
      "arXiv",
      "IEEE"
    ],
    "selectedFilters": {
      "contentType": "research-paper",
      "language": "en",
      "hasCode": true
    }
  }
}
'

import requests

url = "https://api.sophra.org/api/cortex/analytics/search"

payload = {
    "query": "machine learning optimization",
    "searchType": "hybrid",
    "totalHits": 150,
    "took": 234,
    "sessionId": "sess_abc123",
    "facets": {
        "authors": ["John Smith", "Jane Doe"],
        "tags": ["AI", "ML"],
        "yearPublished": {
            "min": 2020,
            "max": 2024
        },
        "source": ["arXiv", "IEEE"],
        "selectedFilters": {
            "contentType": "research-paper",
            "language": "en",
            "hasCode": True
        }
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    query: 'machine learning optimization',
    searchType: 'hybrid',
    totalHits: 150,
    took: 234,
    sessionId: 'sess_abc123',
    facets: {
      authors: ['John Smith', 'Jane Doe'],
      tags: ['AI', 'ML'],
      yearPublished: {min: 2020, max: 2024},
      source: ['arXiv', 'IEEE'],
      selectedFilters: {contentType: 'research-paper', language: 'en', hasCode: true}
    }
  })
};

fetch('https://api.sophra.org/api/cortex/analytics/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sophra.org/api/cortex/analytics/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'query' => 'machine learning optimization',
    'searchType' => 'hybrid',
    'totalHits' => 150,
    'took' => 234,
    'sessionId' => 'sess_abc123',
    'facets' => [
        'authors' => [
                'John Smith',
                'Jane Doe'
        ],
        'tags' => [
                'AI',
                'ML'
        ],
        'yearPublished' => [
                'min' => 2020,
                'max' => 2024
        ],
        'source' => [
                'arXiv',
                'IEEE'
        ],
        'selectedFilters' => [
                'contentType' => 'research-paper',
                'language' => 'en',
                'hasCode' => true
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sophra.org/api/cortex/analytics/search"

	payload := strings.NewReader("{\n  \"query\": \"machine learning optimization\",\n  \"searchType\": \"hybrid\",\n  \"totalHits\": 150,\n  \"took\": 234,\n  \"sessionId\": \"sess_abc123\",\n  \"facets\": {\n    \"authors\": [\n      \"John Smith\",\n      \"Jane Doe\"\n    ],\n    \"tags\": [\n      \"AI\",\n      \"ML\"\n    ],\n    \"yearPublished\": {\n      \"min\": 2020,\n      \"max\": 2024\n    },\n    \"source\": [\n      \"arXiv\",\n      \"IEEE\"\n    ],\n    \"selectedFilters\": {\n      \"contentType\": \"research-paper\",\n      \"language\": \"en\",\n      \"hasCode\": true\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sophra.org/api/cortex/analytics/search")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"machine learning optimization\",\n  \"searchType\": \"hybrid\",\n  \"totalHits\": 150,\n  \"took\": 234,\n  \"sessionId\": \"sess_abc123\",\n  \"facets\": {\n    \"authors\": [\n      \"John Smith\",\n      \"Jane Doe\"\n    ],\n    \"tags\": [\n      \"AI\",\n      \"ML\"\n    ],\n    \"yearPublished\": {\n      \"min\": 2020,\n      \"max\": 2024\n    },\n    \"source\": [\n      \"arXiv\",\n      \"IEEE\"\n    ],\n    \"selectedFilters\": {\n      \"contentType\": \"research-paper\",\n      \"language\": \"en\",\n      \"hasCode\": true\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sophra.org/api/cortex/analytics/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"machine learning optimization\",\n  \"searchType\": \"hybrid\",\n  \"totalHits\": 150,\n  \"took\": 234,\n  \"sessionId\": \"sess_abc123\",\n  \"facets\": {\n    \"authors\": [\n      \"John Smith\",\n      \"Jane Doe\"\n    ],\n    \"tags\": [\n      \"AI\",\n      \"ML\"\n    ],\n    \"yearPublished\": {\n      \"min\": 2020,\n      \"max\": 2024\n    },\n    \"source\": [\n      \"arXiv\",\n      \"IEEE\"\n    ],\n    \"selectedFilters\": {\n      \"contentType\": \"research-paper\",\n      \"language\": \"en\",\n      \"hasCode\": true\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

Body

application/json

query

string

required

The search query

searchType

enum<string>

required

Type of search performed

Available options:

text,

vector,

hybrid

sessionId

string

required

Session identifier

totalHits

integer

Total number of search results

took

integer

Time taken to perform the search in milliseconds

facets

object

Show child attributes

Response

201

Search analytics logged successfully

Cortex > Metrics

Administration

Cortex > System Health

Cortex > Session Management

Cortex > Index Management

Cortex > Document Operations

Cortex > Search Operations

Cortex > A/B Testing

Cortex > Analytics

Cortex > Feedback

Nous > Health

Nous > A/B Testing

Nous > Adaptation

Nous > Learning > Models

Nous > Learning > Search Patterns

Nous > Learning > Feedback

Nous > Learning > Metrics and Events

Nous > Signals

API Reference

Log Search Analytics

Body

Response